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SECTICN 1 


GLOBAL DATA MANAGEMENT DOMAIN 


1.0 General_Ddescription 


The Global Data Management Domain 1s a centralized system 
Shared component of GCOS8 which performs glebal data manage- 
ment functionss such as opening and closing filess which 
apply to all access methods, 


The functions included in this component are: 


1 The Create Buffer Pool function creates and initializes 
a buffer poot with the input size and sharatility 
attributes. The buffer pool can be referenced by a 12 
character ASCII name, 


Cs The Delete Buffer Pool function deletes the buffer spool 
with the specified name, 


5g The Reserve File function is called during file alloca- 
tion. A shared file structure is created ands, if the 
file is under concurrent access controls a Resource 
Control Block 1s associated with the file and it is 
enqueued on behalf of the requesting process. | 


4. The Remove File function 1s performed during file 
deallocatioan. The Rescurce Control Elock associated 
with the file 1s dequeued for the requesting process 
ands if this is the Last user of the file, the Resource 


Control Block and the shared file structure are 
deleted. 
ae The Open function creates and initializes a File Access 


Domain for the requested access method. Thus the file 
may be opened for access by any of the access methods 
CIOS,» UFAS», Buffer Manaaqements...). An entry descrip=> 
tor to the created File Access Domain is returred to 
the caller to permit access to the file throuch the 
access method domain. 


10. 


11. 


12. 


13. 


The Close function terminates the use of a File Access 
Domain. The entry descriptor to the File Access CDomain 
returned by the Open function is invalidated. 


The Reserve Buffers function is intended for use ty the 
access methocs themselves. Buffers for a file may be 
reserved either when the file is opened or deferred 
until the caller is prepared to access the file. When 
the Latter is desireds this function performs the res- 
ervation so that the file may be accessed. 


The Remove Buffers function removes the reservation of 
buffers for a file or set of files and returns the 
buffers to the available List of the buffer pool. 


The Global Flush function flushes all buffers fer all 
the open files. This function is normally used at com- 
mitment points. 


The Global Close function flushes the buffers and 
closes all the open files. It also will opticnally 
reset the access method and/or buffer manacement 
currencies. This function is normally called at termi- 
nation. 


The Return File Information function returns attributes 


of the file and information about the usage of the 
file. 


The Global Here-I-Go function calls each active IDS [I 
domain at the Here-I-Go entry point to release IDS 
structures. It then removes the buffer reservations 
for every active buffer management domain. 


The Set Control Interval Range function is used to 
specify which part of a file is to be controlled by 
concurrent access if the file is to be split. 


~~ 


2c.’ [oterface_to_the Data Management Domain 


The Data Management Domain 1s entered via a CLIMB instruc- 
tion with the function code selecting the particular func- 
tion to be called. The first parameter that 18 fassed 
always describes a command blocks other parameters may be 
required depending on the function executed. A detailed 
description of the parameters and definiticn of the ccmmand 
block is provided along with the description of the individ- 
ual functions. 


et Buffer Pool Fuoctions 
2e1.1 Buffer Pool Command Block (BPCB) 


The BPC& 31s input to the Create and Delete Buffer Pool func- 
tions. These glabal symbols are defined by the CSY46.M 


macro. 
0 9 18 35 
Oo tS SSOIMMAG 
| --------- ----------- -- ------------------------------------ | 
1 | DORG.6 
| - ----- -------------------- ----+------------------ ---------- 
2 | | 
DBPI.6 | 
| | 
| ------ -------------- -------------------------------------- | 
5 | DMXB.6 DMNB.6 | 
| --------- -------~+---+-+------+------------------------------ 
6 | RFU lDBTP. 61DLVL. 61 DZBF.6 | 
| -------------------- --------- ------------------- ---------- | 


Figure 1.2-1. Buffer Pool Command Block 


DIMM .6 Immediate status 
DORG.6 Original status 
DBPI.6 Buffer Pool Name (3 words) 
DMXB.6 Maximum number of buffers in pool (18 bits) 
DMNB.6 Minimum number of buffers in pool (18 bits) 
OBTP.6 Buffer pool type (2 bitss bits 9-10) 
DPBZ .6 public buffer pool 
DPVZ.6 orivate buffer pool 
OLVL.6 Buffer pool level (7 bits) 
DPRY .6 process level 
DWSY.6 work staticn Level 
OSY Y 26 system Level 
DZEF .6 Buffer size in words (18 bits) 


This function creates a buffer pool with the specified 
sharability and size. The buffer pool may be public (any 
file can be assigned to it) or private (only certains 
specified files can be assigned to it). The buffer pool 
will remain active until explicitly deleted by the Delete 
Buffer Pool function or until the working space in which it 
resides is freed. 


Focmat 
XCALL segidsns-DCBP.Feerror-exit 


where n = 1 if the buffer pool is public and 
n= 2 if the buffer pool is private 
Parameters 


- descriptor OQ : frames the Buffer Pool Command Block (BPCB) 
- descriptor 1 : frames the private file list 


Buffer Foot Command Bleck (BeC8) Parameters 

Ineut — 
DBPI.4 Name of the buffer pool to be created 
OMXB.6 Maximum number of buffers in pool 
DMNB.6 Minimum number of buffers in pool 
OBTP.6 Buffer pool type (public or private) 
DLVL.6 Buffer pocl level (process, workstation 

or system) 

DZBF.6 Buffer size in words 

Qutout 


DIMM.6 Immediate status 
DORG.46 Original status 


Seats farses 


18 35 

0 VNUNEER FILE TD'S 1 RFU 
| ------------------------------------- --! 

1 | RFU | 
| ---------------------------------------| 

2 | UNIQUE FILE IDENTIFIER 1 | 
| | 

| ------------ --------------------------- | 

4 | UNIQUE FILE IDENTIFIER 2 | 
| 

| --------------------------------------- | 

| s e s j 

i s @ @ | 

| ‘ : " | 

| ------~--------------------------------- | 
mI UNIQUE FILE IDENTIFIER n | 


Function 

If the buffer pool name is uniques, the control struc- 
tures which describe the buffer pcol are created. 
Space is allowed for the pool to grow to reach the max- 
imum number of buffers that was specified. The minimum 
number of buffers specified are created and initialized 
in the pool. | 


If this is a private buffer poole file control struc- 
tures for each of the input files 1s created and 
associated with the buffer pool. 


NOTE > PRIVATE BUFFER POOLS ARE NOT SUPPORTED IN SR 
10C0. 


uw. <3 Delete Buffer Pogl (DDBP,F) 


This 
name. 


function deletes the buffer pool with the specified 
Alt files must have been "removed" that were 


associated with the buffer pcol. 


Eormat 
XCALL segidsz1,00BP.Feerror-exit 


Parameters 


- descriptor (Q : frames the Buffer Pool Command Block 


Buffer Pool Command Block (BPCB) Parameters 
Logut 
OBPI.6 Buffer pool name 
OLVL.6 Buffer pcol level (processs work station, 
Qutaut 


DIMM .6 Immediate status 
DORG .6 Original status 


Functian 3 

The buffer pocls are searched for a match on the ingut 
name and a check made to insure that all files 
associated with the buffer pool are inactive. 


If the buffer pool is privates the file control struc- 
tures for the files assigned to the buffer pocl are 
deleted. 


The buffers and buffer pool control structures are then 
deleted. 


system) 


ew. File Reservatioo_Functigas 
2.2.1 Fide Reservation. Command Block CFRCB) 


The FRCB is input to the Reserve and Remove File Functions. 
These global symbols are defined by the DSY3.M macro. 


0 9 | 18 | 35 
0 tf SSSUIMMSS 
| — ee ee ee ee we ow ewe -—<_ «= os = a 2 a wae os a ae en sans wwe wae ae wen ew ww > <> a) 6D ab an am om | 
1 | DORG.3 | 
| iss i: Sl << t-test“ se ea ssh aes“ ay Sap ep sin se cu. “al eg Jase ae le cea as a on ow ae we ew a | 
2 | DLFI.3 | 
| | 
| Oe er rn rer eer ersten ial sa eb ao Sse ins": a) Sp ms gs as a. 2 ab nae an. a om | 
| | | 
6 | DFLG.3 | DRST.3 | O76 145 | 
| ab aap ah em sa a A OO ED Ae a a a ea ea a ee asa Jain ei has en la i ly cc in Ce a a al i a ae es cel, eee al cs eal te } 
v4 | ; | 
| | | 
| Si ice-cold 5 il ts 7) Sune. <i el es. tags ee sash ak aa: ss i ead “aah zum cs cael Set “ese oe co "sl “aes ih a; mas i -."ee | 
10 | OTIV.3 | 
| _ <-> ae we ae ow Ss sa ae eau A bei tan cs Ss as» Sn ‘le lc ‘cain antl al a, sc ii Som“ ab ae th a a aba wb am wn at a0 i 


M4 | RFU | 


Figure 1.272. File Reservation Command Block 


DIMM .3 Immediate Status 

DORG.3 Original Status 

DLFI.3 Local File Identifier (2 words) 
SCT address (1 word) 
sector number of FD (1 word) 

DUFI.3 Unique File Identifier (2 words) 
creation date and time 

OFLG.3 Flags (9 bits) 


DSHZ.2 if ons file is sharable 

DBFZ.3 if ons file is protected by before journalization 
DAFZ.3 if ons file is protected by after journaliZation 
DOUZ.3 if one file is protected by duplicate file 

DPMZ.3 if cons file is a permanent file | 


DCAZ.3 if one copy A of duplicate file is defective 
0€82.3 if ons copy B of duplicate file is defective 
ORST.3 Reservation type (9 bits) 


DNOY.3 no concurrent access 
DEFY.3 exclusive access at file level 
DSFY.3 shared access at file level 


DSEY.3 shared access to files both shared and exclusive 
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access to CI's 
OSCY.3 shared access to files shared access to CI'’s 
DECY.3 Shared access to files exclusive access to CI's 
OZC1I.3 Control Interval size in words (18 bits) 
DBPI.3 Buffer Pool Name (3 words) 
OTIV.3 Timer value to be used when reserving the files in units 
of 1/64 milliseconds 


ew .2 Reserve File (ORSE.ED 


This function creates a structure which describes the file, 
allocates a Resource Control Block for the file (Cif under 
concurrent access control),s» and enqueues or reserves” the 
file for the specified process. This function must be 
executed for a protected file before that file can be 
opened. Non-protected files will be "reserved" as part of 
the Open File function. 


Format 
XCALL segidsi,-DRSF.Fe,errorn-exit 


Pacameters 
- cescriptor C 3: frames the File Reservation Command Block (CFRCB) 


File Reservation Command Block. CFRCB) Parameters 


Iogut 
DLFI.3 Local file identifier 
DUFI.3 Unique file identifier 
DFLG.3 Flags 
OSHZ.3 sharable 
OBFZ.3 befcre journal 
DAFZ.3 after journal 
DOUZ.3 duplicate file 
CDPMZ.3 permanent file 
DCAZ.3 copy A defective 
DCB8Z.3 copy 8 defective 
~DRST.3 Reservation type 
OZCI.3 CI sizer if zeros this parameter must be supclied 
to the Open File function. 
DBPI.3 Buffer Pocl Name; if zero a buffer pool will be 
chosen automatically when the file is opened. 
OTIV.3 Maximum length of time the process 1s willing 
to wait for the concurrent access reservation. 


Qutput 
DIMM. 3 Immediate Status 


DORG.3 Original Status 


Function 

A search for the file structure is made based = on 
DLFI.3 and oOUFI.3. If not found, the file structure 
7S created and, 1f concurrent access 18S desireds a 
Resource Control Block is allocated for the file and 
the file is reserved (RCB8B is enqueued). 


If OB8PI.3 is specifieds then the file is associated 
with the buffer pool with the specified name. 


=m ap «<@ «<p ——- = 


This function removes the file from the reservation list for 
the calling process. It 3s called at process termination 
for all files reserved or allocated by the process. This 
function must be preceded by a Commit function. 


Format : : 
XCALL segids1/,DRMF.Fe,errorvexit 


Pacametecs 
- descriptor © : frames the FRCB 


Eide Reservation Command Block (CFRCB) Parameters 


Loput 
DLFI.3 Local file identifier 
DUFI.3 Unique file identifier 


Cutout 
DIMM. 3 Immediate status 
DORG.3 Original status 


Functian 
A search for the file structure is made based on OLFI.3 
and DUFI.3. The count of the outstanding reservations 


against the file is decremented ands if zercs the 


Resource Control Block is deallocated and the file 
structures celeted. 


1274 


2% Qnen_ File Function 
2e65-1 Qpen Command Block COPCB) 


The OPCB is input to the Open File function. 
These global symbols are defined by the DSY1.M macro. 


0 18 35 
QO fo SSOUOIMMAT —OSSS 
{ wee <2 ap an onan a. <a << aD an an aD oe ae om on 5 cm el a i i tila mel aan gaa’ cS aa. i mis ss ihe ec ea ou i aa. | 
1 I DORG.1 | 
| ian a mis ‘ca ssc <_< a> <2 = Scien seu <a tesa so aap etic smh sma “ea i, <a Se ih: ee eae ga is a ins ce as ssi as aa eg a lh et | 
2 | DDCM.1 | DLVL.1 | 
| ----------------------------- 2----------------------------- | 
3 | RFU | 
| --------------------------- -------------------------------- | 
4 | | 
| ACCESS | 
| METHOD | 
| SPECIFIC 
ko | 


A A A A AD AD ON A A ND ED ED A ED ED ED ED D  EED  D OD ND EDO EP RD D-DD ee ee SD De ee a Se oe a OD a -om -o 


Figure 1.273. Open-Close Command Block 


DIMM .1 Immediate Status 
DORG.1 Original Status 
DDOCM.1 Desired access method domain (18 bits) 
DBMY .1 Buffer Management 
DUFY.1 UFAS 
DIDY.1 IDS 
DBJY.1 Before Journal 
DIXY.1 Indexed Access 
DLVL.1 Level of Access (18 bits) 
DPRY.1 process 
OWSY.1 work station 
DSYY.1 system 


Words 4 =- k of the OPCB are defined based on the access 
method chosen by specifying DDOM.1. 
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éNu.2 Qneo-file-(DOPN AF) 


The Open File function creates and initializes a file access 
domain through which the caller can access the file. The 
particular type cf domain depends. on the access method 
chosen through specification of DDOM.1. 


Format 
XCALL segidsns-DOPN.~Feerror-exit 


where n = the number of descriptors passed on the Argument/Parameter 
Stack ; | 


Parameters 

- descriptor 0 : frames the OPCB 

- descriptor 1 : frames the identifier of the calling 
domain 

- descriptor 2 : frames an area of the caller's demain where 
the Open File function will store an entry 
descriptor (T=11) to the created file access 
domain 

- descriptors 3-n : Access Method Specific 
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2X-.2.1 Buffer Management _Qoen 
The Buffer Management Open is selected by setting DDOM.1 = DBMY.1 


Parameters 
No additional descriptors on the Argument/Parameter Stack 
are required by Buffer Management. 


Buffer Management Specific QPCE for Qpen 
In addition to the four words defined for the OPCB in the general Open 
File function, Buffer Management requires the following: 


0 9 18 35 
~ {ee ee eee ~*~C~C~C 
| 

| i adc ui et “cl “sls sa ek Samat "ano “ks aca is. se aia aa “ete i ail: iets sen a i “Sts is scan ill nl ey i a ae Sem Sei | 

6 |  DFLG.1 | RFU | ao ae | 
| eee am ee a ae ee ee ee ee ee ae we oe ee ee we ee a ee ae ee ee we ee oe en ee ee eee a ae ee we we | 

4 | DNBF.1 | DMLK.1 | 
| shi cia ia sium“. ei ean “ala Gs a > a a a a a as k es sn c’e  < e cs <a cl Sus el oi Seis a si soaks‘: Sb Sa a a en an me en On a a =| 

8 | DNCI.1 | RFU | 
| — we we eae ee ee i a Sl ai ta ap a in ni ail ime ena ees i> aii SS om iig wee we wen wwe oe | 

9 | RFU DFID. | 
| s/n: Nisa i eg’ "ce? “ei. ii ei i: "wtp aa ap, i a: es tie een: Si. si ei sce esa, <email ss | 

10 | DFST.1 | 
j <> <n a) en On a a a a ae oe oe Lp ab Ae a AO A all ND OD a a a | Siac li i cas Se Sc, ein com’ Gay“ So ata | 
4 RFU | 


Figure 1.274. Buffer Management Specific Section of CPCB 
Open Command Elock (QPCB) Parameters 
input 


DFLC.1 File codes 8 ASCII characterss» left justifieds blank filled 
DFLG.1 Flags (9 bits) 


0S$QZ.1 if ons file 185 Sequential 

DFSZ.1 if ons file is member of file set 

DBRZ.1 If ons buffer reservation is to be deferred 
DLDZ.1 if one cpen is for load mode (tape) 


OZCI.1 Control Interval size in werds (718 bits) 
ONBF.14 Number of buffers desired for this file set 
OMLK.1 Maximum number of buffers that can be Locked at any. 
one time for this file set (18 bits) 
ONCI.1 Number of CI's per buffer (18 bits) | 
DFST.1 File set identifiers input only if this file is a 
| - member of a file set (DFSZ.1=1). Wher opening the 
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first file of a file set» this parameter should 
be zero. It will be returned as an Output parameter. 


Qutegut 
DFID.1 File identifiers this parameter is required input 
to other Buffer Management functions when the file 
is a@ member of a file set. 
OFST.7 File set identifiers this parameter is required 
Input to some other global Data Manacement functions 
OZCI.1 Control Interval size- if zero on inguts the correct 
value for CI size will be returned. | 
Function 
1. If the file has already been opened by this users 


Increment 


the count of the number of opens for this user 


and return the entry descriptor to the existing Euffer 
Management domain. 


2e Search 


for the Peripheral Allocation Table (PAT) based 


on the input file code. Construct a local file identifier 
from the SCT address and sector number of the FD frem the 
PAT. Find the file structure created by the File Reserve 


function, 
structure 


3. If the 
then find 
cannot be 


4. I f 


if protected file. If not founds create file 
by executing Reserve File function. 


file has not yet been assigned to a buffer pool, 
a pool with buffers of the correct size. If one 
founds create a new buffer pool. 


deferred buffer reservation 1s not desired 


(DB8RZ.1=0)-, then reserve the desired number of buffers for 


the file. 


5. Return an entry descriptor to the Buffer Manacement 
domain for this file. 


Te=15 


2S Close File _Functioano 


2.4.1 Close Command Block (CCLCB) 


The CLCB is input to the Close File function. These global 
symbols are defined by the DSY2.M macro. 


0 


18 


35 


> aD -D aap «<> eee ap ~<a 42 4. a oe oe ee Se ee SD ee Se 2 Se ee 2 ee ee <2 SS ee 6 ee =e Se oD SD ee oe Se ee ee 2 ee ee a ee <-> SD -a a 


DIMM.2 


(wesc Cece c ees e eS BS ake a ee ee enter aera’ ao era ce seabed Bae 


RFU 


ACCESS 
METHOD 
SPECIFIC 


aD “CD EP ED <O) ED OEP <P UD ED ED << ~~ - ee es a e -  -  --  e 


Figure 1.2=-5. 


DIMM.2 Immediate Status 
DORG.2 Original Status 


Close Command Block 


DDOM.2 Desired access method domain (18 bits) 
OBMY.2 Buffer Management 


DUFY.2 UFAS 
DIDY.2 IDS 


DBJY.2 Sefore Journal 
OIXY.2 Indexed Access 
DLVL.2 Level of Access 


DPRY.2 crocess 


DWSY.2 work station 


DSYY.2 system 


Words 4 = k of the CLCB are defined based on the access 


(18 bits) 


method chasen by specifying DDOM.2. 


QW .2 Close_File (DCLS,F) 


The Close File function terminates the usage of a file access 
domain. The domain is deleted so that the file 1s no longer 
accessible through it. 


Focmat 
XCALL segidsn-DCLS.Faeerror-exit 


where n is the number of descriptors passed on the 
Argument/Parameter stack: 


Parameters 


- descriptor CG : frames the CLCB 

- descriptor 1 : frames the domain identifier of the caller 

—- cescriptor ec: frames the entry descriptor of the file access 
domain returned by the Open File function 

- descriptor 3- n 3: access method specific 
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Qn e2el Buffec_Management Specific Close 


The Buffer Management Close is selected by setting 
DDOM.2 = DBMY.2 


Parameters 2. 4 : 

No additional descriptors are required by Buffer Management other than 
the three passed an the Argument/Parameter stack described in the 
general Close File function. 


Buffer Management Specific CLCB 
The following access method specific portion of the Clcse 
Command Block 1s required by Buffer Management. 


0 9 18 35 
4 | DFLC.2 | 
| | 
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Figure 1.276. auffer Management Specific CLCB 


QPCB_ Parameters 
ingut 

OPEL Cee File codes 8 ASCII characters, Left justifieds blank filled 
DFID.2 File identifiers returned by the Open File function (18 bits) 

Function 

1. Search for Buffer Management file access domain based on 

Inout file code (DFLC.2). Check the input entry descriptor 

for validity. 

2% Decrement the number of times this domain has been 

opened, If zeros then flush the buffers and delete the 


local user-related structures, 


3. If all files of the file set have been closeds release 
the buffers and delete the Buffer Management domain. 


i eal 


&\. Buffer. Reservation_ Functions 


2odel Reserve Remove Buffers Command Block (CRBCB2 


This block is input to both the Reserve and Remove Buffers 
functions. These global symbcls are defined by the (CSY7.M 


macroe 

0 | 18 | 35 
O fe SSSSDQEMMOP 
(zs  . =e eee wera 
_.° ~~. a 
;: vues f° is + el | 
eee aaaaae 


> > ep Ep ap a 4 ee a a e  e  - ee ee a ss «ee ee Oe -  e e e  e e  * e - 


Figure 1.277. Reserve-Remove 3uffers Command Block 


DIMM .7 Immeciate status 
DORG.? Original status 
DFST.?7 File set identifier 
ONBF.7 Number of buffers desired for the file set (18 bits) 
DMLK.7 Maximum number of buffers that can be Locked 
at any one time for the file set (18 bits) 
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2M-.2 Reserve Buffecs_(ORSBAF) 


This function reserves or allccates the required numter of 
buffers from the buffer pool for a given file set. This 
function is designed to be used when the "deferred buffer 
reservation" option of the Cpen File function is specified 
at Buffer Management level. 


Format 
XCALL segidsiszDRSB.Feerror-exit 


Parameters 
- descriptor Q : frames the RBCB 


RBCB_ Parameters 
ingut 


OFST.7 File set identifier for which the buffers are to 
be reserveds returned by the Open File function 

DNBF.7 Desired number of buffers fcr the file set. 

OMLK.7 Maximum number of buffers that can be locked for 
the file set. 


Qutout | 
DIMM.7 Immediate status 
DORG.?7 Original status 


Function 

1. If the input values for DNBF.L? and DMLK.?7 are greater 
than those previously specified (via an Open File furction 
or another Reserve Buffers function)ds- then use the input 
values. 


2. If the required number of buffers has not yet been 
reserved, then decrement the "available number of buffers” 
count for the buffer pools, if necessary creating new buffers 
up to the maximum number of buffers for the buffer pool. 


3. If the required number of buffers are not available, wait. 
the process on a semaphore associated with the buffer pocl. 


I f the buffers are strit not available after a 
pre-determined elapsed times then return an error to the 
caller. 


4. When the file is accessed via the Get Control Interval 
(BGCI.F) function of Buffer Management and the buffers have 
not yet been reserved, Buffer Management will call this 
function to reserve the number of buffers specified when the 
file was opened. 


& .3 Remave Buffers _ (ORMBLF) 


This function removes buffers from the reservation list and 
returns them to the buffer pool as available buffers. 


Eormat 
XCALL segidsg1l/DRMB.Feerror-exit 


Parameters 
“descriptor O : frames the RECB 


RBC8 _ Paraaters 
Ineut 
DFST.7 File set identifier 


Qutgut 
DIMM.7 Immediate status 
DORG.7 Original status 


Euyoctiong 


The buffers that have been reserved for the specifiec file 
set are returned to the buffer pool as available buffers. 
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&& Global_flush Function 
20.6.1 Global Flush Command Block 


This command block is input to the Global Flush Function. 
These global symbols are defined by the DSY4.M macro. 
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Figure 1.2-8. Global Flush Command Block 


DIMM .4 Immeciate Status 
DORG.4 Original Status 
DFLG.4 Flags (183 bits) 


DGFZ.4 Delete Buffer Currencies 
DPJZ.4 Physically journalize after images 
DRBZ.4 Delete record and buffer currencies 


DLVL.4 “Access Level (18 bits) 
DPRY .4 process | 
DWSY.4 work station 
DSYY.4 System 


Tee 


A&«2 Global_Flush COGFLVF) 


This function flushes all buffers of all open files at the 
specified access level. 


Format 
XCALL segidsi-zDGFL.Feerror-exit 


Parameters 
~descriptor 0 : frames the GFCB 


GECB_ Parameters 
Inayt 
DFLG.4 Flags 
DBFZ.4 delete buffer currencies 
DPJZ.4 physically journalize after images 
DRBZ.4 delete record and buffer currencies 
DLVL.4 Access level 


) 


Qutout 
DIMM.4 Immediate status 
DORG.4 Original status 


Function | | 

For each open file at the specified level the following 

functions are perfcrmed: 
14 if buffer currencies are to be deleted, the access 
method domain is called to destroy its copy of the cuffer 
currencies ands if O0R8Z.4 is sets also destroy its record 
currencies. ? 


2e. the buffer management domain is called to flush the 
buffers. 


3. if the currencies are te be deleted (D®BFZ.4 or CRBZ.4 
= 1), then the Reservation Entry associated with this 
file is releaseds thus allowing use of the file by a dif- 
ferent process. 


A Global Close Function 
2efel Global_Clese Command Block. 


This command block is input to the Global Close Function. 
These glovtval symbols are defined by the DSY5.M macro. 
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Figure 1.279. Global Close Command Block 


DIMM .5 Immeciate Status 

DORG.5 Original Status 

DLVL.5 Access level (18 bits) 
DPRY.5 oprocess 
DWSY.5 work station 
DSYY.5 system 
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yee Global Close (COGCL.F2 


This function flushes the buffers and closes all files that 


are open at the specified access level. 


Format 
XCALL segids1l/-DGCL.Fseerror-exit 


Pargmeters 
“descriptor 0 : frames the GFCBE 


GFCB_ Parameters 
Inout 
DLVL.5 Access level 


Qutout 
DIMM.5 Immediate status 
DORG.S5 Original status 


Fuoction 
For each file that 18 open at the specified access 


the corresponding access method domain is called to close 


the file, 
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A Global _vere=1-Go_function 
228.1 Global _ Here-I1-Go_ Command Bieck_ 
This command block is input to the Global Here-I-Go Func- 


tion. These global symbols are defined by the DSYO.M macro. 
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Figure 1.2710. Global Here-I-Go Command Block 


DIMM .0 Immeciate Status 

DORG.O Original Status 

OLVL.O Access level (18 bits) 
DPRY.O process 
DWSY.O0 work station 
DSYY.0 system 


1=2c 


202 Global Here-I1-Go_ (OGHG.E) 


This function calls each active IDS II domain for the 
specified access level at the Here-I-Go entry point. 


Format 
XCALL segidsz1i/-DGHG.Feerror-exit 
Parameters 
- descriptor O 3: frames the Global Here-I-Go Command Block 
GHCB_Parameters 
input 


OLVL.O Access Level 


Qutput 
DIMM.O Immediate Status 
DORG.O Original Status 


Functiana 

Each of the active IDS II domains will be deactivated by 
this command until another Here-I~Am command is executed. 
IDS releases local structures such as the DECB (see IDS dac- 
umentation). Then for each open Buffer Management comain 
for the Levels a Remove Buffers function is executed. 
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L“S File Joforcmation_Function 


2.9.1 
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File_loformation_ Control Bleck (FICB8) 
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Figure 1.2-11. File Information Control Block (FICB) 


= 28 


f* 


NOY | | 
es? ) Returo File Loformation CORFI,F) 


This function returns information about the file that 
maintained in the Global Data Management domain. Five ver- 
sions of the function govern the specific information 
returned as well as the manner of identifying the file on 


input. 
Format | 
XCALL segide1l»-~DRFI.Feerror-~exit 
Parameters 
- descriptor 0 : frames the FIC8 
FICS8 Parameters 
ingut 
DRQT.8 Function types this parameter determines 


which version of the function 18 executed: 


=4 DFLC.8 18 input 
Groups IsII-II I-IV are output 
=2 OLFI.8 3S Input 
Groups II,III are output 
=3 DLFI.~8 is input 
Groups I-vIIsIIlI«eV are output 
=4 DUFI.8 1s input | 
Groups II-IV are output 
=5 DUFI.8 1S Input | 
Groups I-,II,-IV-V are output 
DLVL.8 Access Level (128 bits) 
DPRY.8 process 
DWSY.8 work station 
DSYY.3 system | 
DFLC.8 File codes eight ASCII characterss left 
blank filled 
DLFI.8 Local file identifier, 
SCT address (1 word) 
sector number of FD (1 word) 
DUFI.8 Unique file identifier (2 words) 


Qutaout 
DIMMN.8 Immediate status 
DORG.8 Original status 


Grougo_I_ CFile Usage Information) 
DRST.8 Reservation type (9 bits) 
DRSE.8 Reservation Entry for file (18 bits) 
DFUS.8 File Usage State (18 bits) 
DRFZ.~8 if ons file has been reserved 
DOPZ.8 if on» file has been apened 


justified, 


DFSZ.8& if ons file is a member of a file set 
DEVZ.8 if ons the file is a tape file anc the 
; current position is at the end of volume 
DERZ.& if ons an unrecoverable error has been encountered 
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returned 


DFID.8 


Buffer Management file identifier (18 bits) 


DNBF.8 Number of buffers desired fer file set (18 bits) 
DMLK.8 Maximum number of buffers that can be locked 
at any one time (18 bits) 
DFST.8 Buffer Management file set identifier 
Grovo_Il_ (File Information) 
ORCB.8 Resource Contrcl Block associated with file (12 bits) 
DZC1.8 Centrol Interval size (18 bits) 
DATR.8 File attributes (18 bits) 
DSHZ.& if ons file is sharable 
DBFZ.8& 1f ons file is protected by before journalization 
DAFZ.8 1f ons file is protected by after journalization 
DDOUZ.8 if ons file is protected by duplicate file 
DPMZ.& if ons file is permanent 
DTPZ.8& 1f ons file is asSigned to tape 
DCAZ.8 if ons copy A of duplicate file is defective 
0€8Z.8 aif ons copy B of duplicate file is defective 
DNCI.8 Number of Control Intervals per buffer(18 bits) 
DBPI.8 Buffer pool name assigned to file (€3 werds) 
DLCI.8 Last Control Interval number for the file. 
Gcoua_lil 
DUFI.8& Unique file identifier (2 words) 
Groug_lVv 
OLFI.8& Local file identifier (€2 words) 
Grcaue_Vv 
DFLC.38 File code (2 words) 


Eyngtion 
Depending on 
identifies 
(DFLC.8)- 


the type of 

the 
the local file 
identifier (COUFI.&). 
the usage of the 
in the FICB. 


request (DRQT.8)- the caller 
inputting either the file cade 
identifier (DLFI.2@), or the tunique 
Information about the file and 
file by the current process is 


file by 


2av0) Set _ Control Interval Range Function 


2.10.1 Set Control Interval Range Command Block 
This command block 1s input to the Set Control Interval 
Range function. These global symbols are defined ey the 
DOSY9.M macro. . 


0 18 35 
Q 1 ris salah le Seah area ss it! i ci a arene “5 aan cs ab an ae ee en =e oe ae oe we pee on om an as ae ae ow oa 
| gs i: mma a ia is ea a mt es i ea ea | a aa cn ls ay tt as si" lip “lain: Gi <a es’ Seat * Se Sin nami Ses ttt “aa ces tains" Caos eh “ci ecw lenis mms es daa | 
1 | DORG.9 I 
| a sen eS: ee en’ “aes apse: Sm: i aici ay ems ei assis: saa ee em ia es sin <a sb ip“ -ms‘:ei’ it | 
2 DFLC.9 | 
a | 
j sii ila is ia ‘a aes gs eh agai Sg i cs a i a a a an aay ai aia tis“ aa el lee cel Sab eis ea “a ms, aaa ] 
4 i RFU | 
{ ladles eat ss cept eh te, tn c= abe ee bl! eS ag das ae le aa a ta ac a a i a i a a a a lc a ea aa a a Ca a } 
5 | DCIN.9 | 


Figure 1.2-12. Set Cantrol Interval Range Command Block 


DIMM .9 Immeciate Status 

DORG.Y Original Status 

OFLC.9 File Code (2 words) 
DCIN.9 Control Interval Number 


Weegee © 


2Svd.2 Set Control_Icterval Range (DCIRF) 


This function is used to specify which part of the file is 
to be controlled by concurrent access when the file is split 
Into two parts: one controlled by concurrent access centrol 
and one not. The control intervals beginning with the input 
number to the’ end of the file will be under concurrent 
access control. 


Format 
XCALL segitds1,0CIR.Feerror-exit 


Parameters 
~descriptor 0 : frames the Set CI Range Command Block 


Command. Block Parameters 


Inogut 
DFLC.9 File Code (ASCII left justified) 
DC IN.9 The first Control Interval number to be under 
concurrency control. 
Qutout 


DIMM.9 Immediate Status 
DORG.Y Original Status 


Euynctian | | 

The file identified by the input file code is found ard the 
dynamic file structures modified to include the input CI 
number. ALL Control Intervals with numbers equal to or 
greater than the input number will be under concurrency con- 
trols those with numbers less than the input number will 
note Note that the file must have been either opened or 
reserved by the process executing this command. 


3.0 Appendix_A_=_Status Codes 


The status codes output by Global Data Management confcrm to 
the return code standard for GCOS 8 modules. The lower half 
words of both the immediate and original status, is troken 
up into two parts: a major status of 10 bits and a minor. 
status of 8 bits. The definitions are: 


MAJOR MINOR MEANING 
1 ~ Ttllegal Command Block Definition 
2 Illegal Domain Identifier input 
3 Illegal Access Level input 
4 Illegal File Code input 
5 Illegal File Set Identifier input 
6 Illegal Control Interval Size input 
7 Illegal Entry Descriptor input 
C Permission to access file in this 
mode is not granted. 
1 11 Input File Attributes conflict with 
those previously specified 


1 12 Illegal Buffer Pool Name 
1 13 File has not been reserved 
1 4 An illegal function was requested 
1 15 Buffer size is too large 
\ 
2 0 Error return from another domain; 


check the original status 
2 1 Illegal device is assigned to the file 
2 2 File not allocated to the process 
2 3 Buffer space is not available 
2 4 Control structure space is not available 
oC 5 File control structures are inconsistent 
2 fe) The file is not open 
2 ? File is already assigned to a 
different buffer pool 


2 10 The file is not closed 

2 11 Buffers are not available 

2 12 An I/0 error was encountered when 
writing buffers or journalizing 

2 13 Vicartous Fauit 

3 Error Status from opening a 
Before Journal 

3 0 Wrong scoce or level 

3 1 Error from Create Linkage Segment 

3 Error from Retrieve Linkage 
Segment template 

3 3 Error from Build Entry Descrigptor 

3 4 


Error from Build Buffer Descriptor 


e5S 


NWN WW 


On Avi 


Error from 
Error from 
Error from 
Error fror 


has7 


Build Op@rand Table 

Euild Tenant Table 

Before Journal slave open 
XGAT call 


The following tables 
by each function. 
Status codes. 
horizontally and the 


Major 


Majar_ Status _=_1 


DCBP.F 
DDOBP.F 
DRSF.F 
DRMF.F 
DOPN.F 
DCLS.F 
DRSB.F 
DRMB.F 
DGFL.F 
OGCL.F 
DGHG.F 
DRFI.F 
OCIR.F 


Malorc_Status_=_2 


DCBP .F 
DDBP.F 
DRSF.F 


DRMF LF 


DOPN.F 
DCLS .F 
DRSB.F 
DRMB.F 
DGFL.F 
DGCL.F 
DGHS.F 
DRFI.F 
DCIR.F 


x «KK KK KR KKK KK OK OK 


9) 


«Kx K WK Ke KK KK KK OK 


define the return codes that are cutput 


separate table 


The 


Minor 
4 5 
x 
x x 

» 4 
x 
Xx 
x 
Minor 
3. OG 
x x 
x 
x xX 
x xX 


Minor Status codes 
functions vertically. 
that the function can return that value for return 


Status 


An 


1s given for each cf the 


are presented 


a aad 


6 ? 1011 12 13 14 15 


x 
x 
Status 
5 6 
x 
x 
x 
x 
x 
x xX 
x 
x 
x 
xX 
x 
Xx Xx 
x Xx 


oe 


X Xx 
x 
x 
x 
x 
i A0 17 12°73 
x 
x x 
x x 
x X 
x x 
xX x 
x. x 
XX 
x Xx 
x Xx 
x Xx 
x 
x 


indicates 


code, 


